home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cdice10.zip / CDICE.DOC < prev    next >
Text File  |  1993-01-01  |  12KB  |  248 lines
  1.             * * * * * * * * * * * * * * * * * * * * * * * * *
  2.             *                                               *
  3.             *               CHALLENGER DICE                 *
  4.             *                 VERSION 1.0                   *
  5.             *                   01/01/92                    *
  6.             *                                               * 
  7.             *                  Written By:                  *
  8.             *                 Michael Goetz                 *
  9.             *                                               *
  10.             *              Copyright (c)  1993              *
  11.             *              All Rights Reserved              *
  12.             *                                               *
  13.             *                 SUPPORT  BBS:                 *
  14.             *               The Caverns EBBS                *
  15.             *                (407) 521-9886                 *
  16.             *         PCB 14.5 * HST D/S 1200-38,400        *
  17.             *                                               *
  18.             * * * * * * * * * * * * * * * * * * * * * * * * * 
  19.  
  20.  INTRODUCTION
  21.  ------------
  22.  
  23.  CHALLENGER DICE is a fast-paced multi-player (2-4 Players) dice game
  24.  for Bulletin Board Systems.   It requires a small amount of strategy
  25.  and a lot luck! The object of the game is to completely cover as many
  26.  of the grouped (colored) blocks as possible. You can roll the dice as
  27.  many times as you like attempting to make matches, but beware of those
  28.  3 Joker dice... if you roll all three before you end the game, you'll
  29.  lose all the points you've earned that turn! If you end the game be-
  30.  fore rolling all 3 Jokers, your current points will be added to your
  31.  your game score. The trick is knowing when to hold and when to fold!
  32.  
  33.  FEATURES
  34.  --------
  35.  - ANSI color and Mono screens
  36.  - Supports up to 230k bps!
  37.  - Supports most BBS Software
  38.  - Supports Multi-node Systems
  39.  - Supports non-standard port & IRQ
  40.  - Supports FOSSIL drivers
  41.  - Digiboard support
  42.  - 16550AN UART support
  43.  - Multi-node - Multi-BBS support
  44.  - Easy installation and maintainance
  45.  - Creates graphic/non-graphic bulletin (Reg. Req.)
  46.  - Automatically maintained Bulletin/Top Score
  47.                               
  48.  INSTALLATION
  49.  ------------
  50.  Installation is very easy.  Create a directory to hold all the CHALLENGER
  51.  DICE files and unzip CDICExx.ZIP into this directory.
  52.  
  53.  Files should consist of:
  54.   CDICE10.EXE  .... Main program file
  55.   CDSETUP.EXE ..... Setup utility to create configuration file (CDICE.CFG)
  56.   CDICE.ANS ....... Main game screen file  (Do Not Modify or Delete!!!)
  57.   WINNER.ANS ...... Winner screen file  (Do Not Modify or Delete!!!)
  58.   CDICE.INS  ...... On-line Instruction file
  59.   CDICE   ......... Sample batch file (modify as needed)
  60.   CDICE.CFG  ...... Sample configuration file (read by CDSETUP.EXE)
  61.   CDKILL.EXE ...... Bulletin - Top Score maintainance file
  62.   CDICE.DOC   ..... You're reading it!
  63.   REGISTER.FRM .... Please use it... I need the money !!   :-)
  64.   FILE_ID.DIZ ..... Description file
  65.  
  66.  Change to the directory you created and run CDSETUP.EXE and enter the
  67.  data in the fields as applicable to your system.  The first line will 
  68.  ask for the full path and filename of your BBS information file.  For
  69.  example: C:\PCB\PCBOARD.SYS.  CHALLENGER DICE uses this information to
  70.  determine the BBS software which is being used as follows:
  71.  
  72.  PCBOARD.SYS   (PCBoard)
  73.  CALLINFO.BBS  (Wildcat!)
  74.  DOORS.SYS     (Spitfire)
  75.  DOOR.SYS      (GAP and other systems using std. DOOR.SYS)
  76.  DORINFOx.DEF  (QuickBBS/Remote Access)
  77.  
  78.  NOTE: DO NOT EXCEED 35 CHARACTERS FOR THE SYSTEM PATH!!
  79.  =======================================================
  80.  
  81.  Line <4> will ask for the path and name for the Bulletin file that
  82.  will be created after each completed game.   This will be an ANSI
  83.  file, displayed in color (if the user supports color). The Bulletin
  84.  will only be created with the REGISTERED VERSION.  Until registered, 
  85.  place "NONE" in this field.  
  86.  
  87.  Line <5> will ask for the maximum number of games a player can be
  88.  involved in at any given time.   The maximum is 15 games (Registered
  89.  copies Only).  Until registered, the maximum is 2 games.
  90.  
  91.  Line <6> will ask for the registration code number.  Until the program
  92.  is registered, place 00000 in the Registration field.
  93.  
  94.  Line <7> asks for each game's Winning Top Score.  When a game reaches
  95.  or exceeds this value, the game will end and the Winner will receive
  96.  150 points in the tournament race.  His/her opponents will have their
  97.  Tournament Score (if it exists) reduced by 50 points.  The default for
  98.  the non-registered door is 2500 points. I would suggest a value between
  99.  2500 and 3500 points.
  100.  
  101.  Line <8> asks for the total number of Top Scores to write to the
  102.  Top Score File and Bulletin.  NOTE: UNREGISTERED VERSION forces 5.
  103.  Until registered, please enter 5 into this field.
  104.  
  105.  NOTE: ALL FIELDS *MUST* BE FILLED IN OR PROGRAM FAILURE WILL OCCUR !!
  106.  ---------------------------------------------------------------------
  107.  
  108.  After entering all of the information, exit CDSETUP.EXE by pressing
  109.  <S>ave....  This will create the CDICE.CFG file and place it in the
  110.  current directory.  
  111.  
  112.  Consult your BBS Software manual on how to create a DOOR batch file,
  113.  and modify the CDICE batch file supplied.  An example batch file for
  114.  PCBoard:
  115.  
  116.   @Echo off
  117.   C:
  118.   CD\PCB\DOORS\CDICE
  119.   CDICE10 CDICE.CFG       <---- This is the command line for calling
  120.   C:                            CHALLENGER DICE MUST BE THE SAME or
  121.   CD\PCB                        failure will occur !!  For non-standard
  122.   BOARD.BAT                     port address and IRQ, see NOTE below!
  123.  
  124.  NOTE: If you need to specify a non-standard port address and IRQ,
  125.        then you will need to add this information to the BATCH file
  126.        calling CHALLENGER DICE. The syntax is PORT:AAAA:X where AAAA
  127.        is the base address and X is the IRQ. An example batch file:
  128.  
  129.              @echo off
  130.              c:
  131.              cd\pcb\doors\cdice
  132.              cdice10 cdice.cfg PORT:03E8:5  <---- NEW COMMAND LINE!
  133.              c:
  134.              cd\pcb
  135.              board.bat
  136.  
  137.  NON-STANDARD PORT, IRQ, FOSSIL & DIGIBOARD SUPPORT
  138.  --------------------------------------------------
  139.  CHALLENGER DICE will also support use of FOSSIL drivers. The
  140.  syntax for a FOSSIL driver is: PORT:F:P.  The 'F' tells the
  141.  door to use a Fossil driver for it's communications, and the
  142.  'P' following it tells it which port to use for the Fossil.
  143.  Example: PORT:F:1 tells it to use a Fossil driver for port 1.
  144.  
  145.  Digiboard Intelligent Async boards are supported thru the Universal
  146.  DOS driver for Digiboard.  The syntax is the same as the Fossil
  147.  driver except you replace the F with D and give the channel number
  148.  to use.  Example - PORT:D:6 tells CHALLENGER DICE  that it is
  149.  connected to a Digiboard and to use channel 6 on the Digiboard.
  150.  
  151.  CDKILL.EXE is a utility that can be called from the EVENT.SYS (or the
  152.  equivalent for your BBS Software) that will automatically, on the 1st
  153.  of each month,  create/update the  "Last Month's Tournament Winner"
  154.  (which is displayed on the Top Score screen and the Bulletin after
  155.  registering).  It will also delete the previous month's Top Scores
  156.  (CDICE.SCR), making CHALLENGER DICE virtually maintainance free! It
  157.  will only execute if run on the 1st of the month.
  158.  
  159.  NOTE: CDKILL.EXE can be forced to run by entering "CDKILL /u" if desired.
  160.  WARNING: This will delete the Top Score file !!
  161.  
  162.  NOTE!!!
  163.  -------
  164.  If a player should receive a message stating that their chosen game is
  165.  being used by another node, when in fact it isn't, you'll need to delete
  166.  a file in the CDICE directory called GAMELOC.xx, where xx is the number
  167.  of the game in question. These files (GAMELOC.xx) are temporarily created
  168.  when a player opens a specific game number, and deleted after the game is
  169.  completed.  Should the player loss carrier during play, the file will not
  170.  be deleted!
  171.  
  172.  MULTI-NODE SYSTEMS
  173.  ------------------
  174.  When running more than one node, be sure to have a different configuration
  175.  for each node, and create a batch file for each node.  The configuration
  176.  file for each node can be created easily by entering at the dos prompt:
  177.  CDSETUP CDICEx.CFG, where 'x' is the node number.   This will cause
  178.  CDSETUP.EXE to create a configuration file under the name entered rather
  179.  than the default (CDICE.CFG).
  180.  
  181.  Example CDICE2.BAT file:           Example CDICE2.CFG:
  182.  ------------------------           -------------------
  183.  @echo off                         <1> c:\pcb2\pcboard.sys  <--- path to
  184.  c:                                <2> The Caverns EBBS         node 2
  185.  cd\pcb\doors\CDICE                <3> Michael Goetz             system
  186.  CDICE10 CDICE2.CFG                    ....and so on             file.
  187.  c:
  188.  cd\pcb2
  189.  board2.bat
  190.  
  191. REGISTRATION !!
  192. ---------------
  193.  Registration is required if you choose to continue using this door
  194.  program after a 3 or 4 week evaluation period.  When registered, the
  195.  "[UNREGISTERED EVALUATION COPY]" line will be replaced with the name
  196.  of your BBS followed by the SysOp name as well as the removal of the 
  197.  delay built into the opening and closing screens.  Registration will
  198.  also allow you the following features:
  199.  
  200.  -- Creation of a colorful graphic Top Score Bulletin which is updated
  201.     after each completed game.
  202.  -- The total number of Top Scores posted can also be specified in the
  203.     configuration file (maximum of 50).
  204.  -- The amount of GAMES allowed each user per day (max of 10) can be
  205.     specified in the configuration file.
  206.  -- The amount of CHANCES (0-6) each player is given at game start can
  207.     be specified in the configuration file.
  208.  
  209.  To register your copy of CHALLENGER DICE, please fill out the supplied
  210.  registration form  (REGISTER.FRM)  and mail it along with a small
  211.  donation of $25.00 or $30.00  (check or Money Order)  payable to
  212.  Michael Goetz, address on the form.   Please be sure you enter the
  213.  information on the form as it appears in the CDICE.CFG file.  Your
  214.  registration code is based upon this information!
  215.  
  216.  After receiving your registration form, I will pre-register you on the
  217.  Caverns EBBS.  You will then be able to call the Caverns EBBS and receive
  218.  your registration code. Please allow at least 7 days prior to calling.
  219.  If you prefer, I will mail your registration code if you supply a self-
  220.  addressed stamped envelope.   PLEASE SUPPORT SHAREWARE!!
  221.    
  222. APPRECIATION
  223. ------------
  224.  I would like to thank Steve Page, SysOp of the SpeakEasy BBS, for his
  225.  assistance in beta testing the program, and all the users of The Caverns
  226.  EBBS for their assistance, comments, and suggestions!  Their assistance
  227.  in the development of CHALLENGER DICE is sincerely appreciated.
  228.  
  229. SUPPORT
  230. -------
  231.  If you have any questions concerning the setup or operation of
  232.  CHALLENGER DICE, I can be reached via email thru PCRelay's (RIME)
  233.  BBS-DOORS conference or at The Caverns EBBS, Majic Software's
  234.  support BBS.
  235.  
  236. LEGALITIES
  237. ----------
  238.  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  239.  WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  240.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  241.  IN NO EVENT SHALL THE AUTHOR OR ANYONE INVOLVED WITH THE CREATION AND PRO-
  242.  DUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
  243.  CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.  YOUR USE OF 
  244.  THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS DISCLAIMER AND YOUR RELEASE
  245.  OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION.
  246.  
  247.                                 - END - 
  248.